Skip to main content

Order Details

๐Ÿ—‚๏ธ Order Details from Third-Partyโ€‹

This API is required to get Single/Basket Order details. Must be developed by the Third-party.

FieldValue
NameGetOrderDetails
URLhttp://<third-party_domain>/GetOrderDetails
DescriptionReceived order (meta data) from third-party will be sent to Trading application
MethodPOST

๐Ÿงพ Requestโ€‹

Header

ParameterDescription
Content-Typeapplication/json

Body

ParameterData TypeMandatory/OptionalDescription
ClientCodeStringMThird-party application user
ProductCodeStringMUnique "Product Code" entered at time of product creation; identifies the published product in the system
AuthCodeStringMGenerated by VAS system (Two-way auth code).
PartnerIdStringMPartnerId of Broker's application used to execute the orders

Example Request

{
"ClientCode": "WAVEUSER1",
"ProductCode": "EQBASKET",
"AuthCode": "auth_code_generated_by_system",
"PartnerId": "XXX-XXX-XX"
}

๐ŸŒ Responseโ€‹

ParameterData TypeMandatory/OptionalDescription
successBooleanMtrue โ€“ Success, false โ€“ Failure
dataStringMJSON string, details of order
messageStringMSuccess/Failure message for the API
statusCodeStringMApplication status code
traceIdStringMSystem generated code by third-party, used for VAS log purpose
productCodevarchar(50)MProduct code as stored in Odin VAS
productTypevarchar(20)MSet default as BASKET
clientCodevarchar(50)MUser Id
recoIdvarchar(6)MUnique per each basket rebalance
orderSidevarchar(10)MOrder side: BUY or SELL
mktSegIdIntMMarketSegmentID of the scrip
scripTknintMScrip token of the scrip
ordTypeIntMOrder type
buyOrSellIntMBuy = 1, Sell = 2
orgQtyIntMOrder quantity
discQtyintMDisclosed quantity
ordPricefloatMOrder Price in paise
trigPriceFloatMOrder trigger price in paise (Mandatory for stop loss orders only; pass 0 for others)
validityIntMValidity of the order
daysvarchar(10)MNumber of days order needs to be carried ahead
ordGTDintM1 if GTD order, else 0
prodTypechar(1)MProductType of the order
sLOrderPricefloatMPrice in paisa
sLTriggerPriceFloatMSL Trigger Price in paisa

** ๐ŸŸข Example Success Response**

{
"success": true,
"data": {
"sProductCode": "QuantechIndiaConsumptionFund",
"sProductType": "BASKET",
"sClientCode": "EMP081",
"sRecoId": "ODINBR016B",
"basketData": [
{
"ordPrice": 0,
"ordGTD": 0,
"prodType": "D",
"orderSide": "SELL",
"sLTriggerPrice": 0,
"buyOrSell": "2",
"sLOrderPrice": 0,
"orgQty": 10,
"mktSegId": 1,
"days": "0",
"scripTkn": 22,
"trigPrice": 0,
"validity": 1,
"ordType": 2,
"discQty": 0
}
]
},
"message": "success",
"statusCode": "prd-200-001",
"traceId": "511b2f00-36ba-4f30-a5bb-a071cebfee5b"
}

Example Failure Response

{
"success": false,
"data": null,
"message": "<respective error message>",
"statusCode": "400",
"traceId": "409dea70-df0d-4909-9321-b4f094f2ecc1"
}